📝 Description

Changes:

• Refactoring of tripwire and region events calculation into an isolated, easily testable primitive functions (independent from controller) operating in batched manner, that can be further optimized and unit tested.
• Adding comprehensive unit tests of the new functions.

Background:

• Short-term goal is to enable unit testing of the functionality in SceneScape and early reuse in DLStreamer PoC of gvaAnalytics element.
• Long-term goal is to establish a common interface that encapsulates the functionality and enables future optimizations (batch processing, C++ implementation) and reuse.

✨ Type of Change

Select the type of change your PR introduces:

• 🐞 Bug fix – Non-breaking change which fixes an issue
• 🚀 New feature – Non-breaking change which adds functionality
• 🔨 Refactor – Non-breaking change which refactors the code base
• 💥 Breaking change – Changes that break existing functionality
• 📚 Documentation update
• 🔒 Security update
• 🧪 Tests
• 🚂 CI

🧪 Testing Scenarios

Validated with the following automated tests: mqtt-tripwire, mqtt-roi, geometry-unit

• ✅ Tested manually
• 🤖 Ran automated end-to-end tests

✅ Checklist

Before submitting the PR, ensure the following:

• 🔍 PR title is clear and descriptive
• 📝 For internal contributors: If applicable, include the JIRA ticket number (e.g., ITEP-123456) in the PR title. Do not include full URLs
• 💬 I have commented my code, especially in hard-to-understand areas
• 📄 I have made corresponding changes to the documentation
• ✅ I have added tests that prove my fix is effective or my feature works